Skip to content

RecompLauncher support: recomplauncher.json and opengp-cli --prepare - #11

Merged
OfficiallySp merged 2 commits into
mainfrom
recomplauncher
Nov 17, 2026
Merged

OfficiallySp merged 2 commits into
mainfrom
recomplauncher

Conversation

@OfficiallySp

Copy link
Copy Markdown
Member

Summary

With this, players can install OpenGP from RecompLauncher, pick their GP 2 disc image, and the launcher builds the game and starts it. OpenGP's settings show on the game's page there. The package now carries a recomplauncher.json next to the launcher:

RecompLauncher
  pick copy        GP 2 disc image, by ID: GGPE02 (or a RELSAB placeholder header)
  setup step       opengp-cli --prepare --only GGPE02 <image>     # builds the game
  Play             opengp-mkgp2 --iso <image>
  settings         user/settings.toml: video, sound, game, linked cabinets (advanced)
  saves            user/tribackup_*.bin, user/cards, settings.toml, controls.toml

The setup step's version is the package version, so each OpenGP release builds the game again in RecompLauncher. GP 1 stays with OpenGP's own launcher.

 tools/installer/
   main.cpp                    # opengp-cli
+  recomplauncher.json.in      # configured with the version, installed at the package root
 cmake/package.cmake           # + configure_file / install
 README.md                     # + "Get it on RecompLauncher" badge
 docs/packaging.md             # + the new options, the RecompLauncher setup

Code changes (their own commit, used only when the launcher passes the new options):

  • opengp-cli --only ID builds only that game. An image of the other game is refused, with a message naming it.
  • opengp-cli --prepare prints progress <0..1> <text> lines and doesn't wait for a key at the end.

Without these options, opengp-cli behaves as before.

Evidence

  • Schema: the generated recomplauncher.json validates against https://recomplauncher.com/schema/recomplauncher.json with no errors.
  • Before: opengp-cli had no setup mode a launcher can read: \r 42% progress, and a "Press Enter" wait.
    After (local Windows package build, real GP 2 image):
    $ opengp-cli --prepare --only GGPE02 "Mario Kart Arcade GP 2 (USA).iso"
    progress 0.000 Mario Kart Arcade GP 2 (GGPE02)
    progress 0.000 Recompiling Mario Kart Arcade GP 2
    progress 0.100 Compiling 75 files (32 at a time)
    ...
    progress 0.950 Linking
    progress 1.000 Ready to play                                   exit 0 (21 s)
    
    $ opengp-cli --prepare --only GGPE02 "Mario Kart Arcade GP (USA).iso"
    ... is Mario Kart Arcade GP (GGPE01), not Mario Kart Arcade GP 2 (GGPE02). Pick your disc image of Mario Kart Arcade GP 2.   exit 1
    
  • Run again, it says "Already built" (exit 0). Plain opengp-cli behaves as before. The built opengp-mkgp2 boots to the Namco screen headless, both with --iso and with no arguments. 22/22 tests pass.

Merge Danger

Door: two-way

Reverting removes the file and the options. Players who set up through RecompLauncher would lose Easy Setup, but their install and saves are unaffected.

Blast Radius: packaging

One new file at the package root. opengp-cli changes only with the new options. Not yet tried in RecompLauncher itself: whether it accepts .gcm files, whether video/fullscreen addresses TOML tables as its schema says, and whether the console-subsystem programs show a console window when it starts them.

🤖 Generated with Claude Code

OfficiallySp and others added 2 commits November 17, 2026 21:18
--only ID builds that one game, and an image of the other game is an
error that names the game it is. --prepare prints the progress as
"progress <0..1> <text>" lines (RecompLauncher's setup step) and never
waits for a key at the end. Without them opengp-cli works as before.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The package carries a recomplauncher.json (from
tools/installer/recomplauncher.json.in, with the version filled in) next
to the launcher. RecompLauncher asks for the GP 2 disc image (GGPE02, or
a RELSAB placeholder header), builds the game with
opengp-cli --prepare --only GGPE02, and starts opengp-mkgp2 with --iso.
Its setup step is versioned with the package, so each new version builds
the game again. OpenGP's settings (video, sound, game, linked cabinets)
show on the game's page there, and saves are listed for its backups.

README gets the "Get it on RecompLauncher" badge; docs/packaging.md
describes the new opengp-cli options and the RecompLauncher setup.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@OfficiallySp OfficiallySp mentioned this pull request Nov 17, 2026
@OfficiallySp
OfficiallySp merged commit 44cbf1a into main Nov 17, 2026
6 checks passed
@OfficiallySp
OfficiallySp deleted the recomplauncher branch November 17, 2026 21:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant